Launch environments

Launch environment supporting EventKit events. Expects bundle and file name for every file containing data of events to be added into calendar at test launch. Structure is defined in example project’s file events.json.

Example:

let recurringEvents: EventLaunchEnvironment = [ LaunchEnvironmentResourceValue(fileName: "monthly_events", bundleName: "Data") ]
let nearEvents = EventLaunchEnvironment(resources: (fileName: "todays_events", bundleName: "Test data"), (fileName: "this_week_events", bundleName: nil))
let nearEvents = EventLaunchEnvironment(shouldCleanBefore: true, resources: (fileName: "todays_events", bundleName: "Test data"), (fileName: "this_week_events", bundleName: nil))

Launch environment supporting EventKit reminders. Expects bundle and file name for every file containing data of reminders to be added into calendar at test launch. Structure is defined in example project’s file reminders.json.

Example:

let recurringReminders: ReminderLaunchEnvironment = [ LaunchEnvironmentResourceValue(fileName: "johnys_birthday_reminder", bundleName: "Data") ]
let highPriorityReminders = ReminderLaunchEnvironment(resources: (fileName: "automate_release_reminders", bundleName: "Test data"), (fileName: "wwdc_reminders", bundleName: nil))
let highPriorityReminders = ReminderLaunchEnvironment(shouldCleanBefore: true, resources: (fileName: "automate_release_reminders", bundleName: "Test data"), (fileName: "wwdc_reminders", bundleName: nil))

Launch environment supporting Contacts. Expects bundle and file name for every file containing data of contacts to be added to address book at test launch. Structure is defined in example project’s file contacts.json.

Example:

let johnContacts: ContactLaunchEnvironment = [ LaunchEnvironmentResourceValue(fileName: "john", bundleName: "Data") ]
let severalContacts = ContactLaunchEnvironment(resources: (fileName: "michael", bundleName: "Test data"), (fileName: "emma", bundleName: nil))
let severalContacts = ContactLaunchEnvironment(shouldCleanBefore: true, resources: (fileName: "michael", bundleName: "Test data"), (fileName: "emma", bundleName: nil))

Launch environment disabling UIKit animation.

Example:

let disableAnimation = AnimationLaunchEnvironment()

Launch environment informing application that is running in UI test.

Example:

let isInUITest = IsInUITestLaunchEnvironment()

Protocol adapted by all launch enviroment options predefined in AutoMate. It also assures that default handling is provided by AutoMate - AppBuddy.

Simple implementation of LaunchEnvironment that wraps single (key: value) pair for TestLauncher.

Example:

let launchEnvironmentOption = LaunchEnvironment(key: "MADE_WITH_LOVE_BY", value: "PGS")

Most basic and generic structure to pass (key: value) pairs through TestLauncher.

Example:

let launchEnvironmentDictionary: LaunchEnvironments = ["CORPORATION_KEY": "PGS", "PROJECT_KEY": "AutoMate"]

Protocol defining minimal requirements of launch environment option to be handled by framework.

Example:

public struct SimpleLaunchEnvironment: LaunchEnvironmentProtocol {

    public typealias Value = String
    public let value: String
    public var launchEnvironments: [String : String]? {
        return [uniqueIdentifier: value]
    }
    public init(value: String) {
        self.value = value
    }
}

Protocol defining minimal requirements for launch environment option with single values. Provides default implementation for handling singe launch environment by providing key and value.

Example:

public struct SimpleLaunchEnvironment: LaunchEnvironmentWithSingleValue {

    public typealias Value = String
    public let key = "LAUNCH_KEY"
    public var value: String
}

let simple = SimpleLaunchEnvironment(value: "LaunchValue")

Protocol defining minimal requirements for launch environment option with multiple values. Provides default implementation for ExpressibleByArrayLiteral protocol.

Example:

public struct ArrayLaunchEnvironment: LaunchEnvironmentWithMultipleValues {

    public typealias Value = String
    public let valuesCollection: [String]

    public init(valuesCollection: [Value]) {
        self.valuesCollection = valuesCollection
    }
}

let array = ArrayLaunchEnvironment(valuesCollection: ["Value1", "Value2"])
let array = ["Value1", "Value2"] as ArrayLaunchEnvironment

Protocol to be adapted by all LaunchEnvironment options that give ability to clean present data before saving new. To work as expected it requires handing special flag appended at the beginning of launchEnvironment value. It is implemented by predefined in AutoMate options and assures that default handling is provided by AutoMate - AppBuddy

Example:

public struct CleanableSimpleLaunchEnvironment: CleanableLaunchEnvironment, LaunchEnvironmentWithSingleValue {

    public typealias Value = String
    public let key = "LAUNCH_KEY"
    public var value: String
    var shouldCleanBefore: Bool
}

CleanableLaunchEnvironment specialized for launch environment options with multiple values. If predefined in AutoMate option implements LaunchEnvironmentWithMultipleValues and it’s specific enables clean data before saving new one, it conforms to this protocol. It provides few initializers extending LaunchEnvironmentWithMultipleValues initializers.

Example:

public struct CleanableArrayLaunchEnvironment: CleanableLaunchEnvironmentWithMultipleValues {

    public typealias Value = String
    public let valuesCollection: [String]
    public let shouldCleanBefore: Bool

    public init(shouldCleanBefore: Bool, valuesCollection: [Value]) {
        self.valuesCollection = valuesCollection
        self.shouldCleanBefore = shouldCleanBefore
    }
}

Contains basic requirements for type that will be used as value for launch environment.

Example:

public enum DataSource: String, LaunchEnvironmentValue {
    case valid = "mock_valid"
    case error = "mock_error"
}

Launch environment resource model containing informations required to point proper file containing resource data. Expects bundle and file name. If bundle name is nil main bundle will be searched.

Example:

let resource = LaunchEnvironmentResourceValue(fileName: "monthly_events", bundleName: "Data")